Microsoft Teams
The DRUID Portal enables a "build once, deploy anywhere" approach, allowing you to seamlessly integrate your bot into Microsoft Teams.
The MS Teams channel supports sensitive data input.
Prerequisites
Before configuring the MS Teams channel, ensure you have:
- A published Druid bot.
- A MS Teams account.
-
Microsoft Bot Framework enabled on your tenant (for DRUID hybrid and cloud deployments).
- For DRUID hybrid and cloud deployments, the MS Teams channel requires the Microsoft Bot Framework. You can configure the channel only if the Bot Framework is enabled on your tenant. If the channel configuration is unavailable – the Post Office is set to BotService (Bot Details → General) – contact Druid Support to enable the Microsoft Bot Framework on your tenant.
- MS Teams channel integration is not available for Druid on-premise deployments.
Deploy your Druid bot in MS Teams
This section describes how to integrate Druid bots with MS Teams using the Developer Portal. For information on other options you’ve got for MS Teams integration, see Microsoft documentation.
Step 1. Active MS Teams channel in DRUID
- Log in to the Druid Portal and select your bot.
- Click the Channels tab.
- Search for 'teams' and click the MS Teams card.
- The channel configuration modal appears.
- Select the Microsoft Teams option that suits your company's Microsoft Office 365 version, agree to the Microsoft terms and statements and click Publish.
- Copy the Microsoft Application Id as you will need the value at the next step.
The channel activation might take up to 1 minute.
When the channel activation completes, the Microsoft Application Id field is automatically filled in. This is the MS Azure ID associated to your Druid bot.
After the channel activates, Druid automatically provisions the following [[ChatUser]] parameters in the conversation context:
- [[ChatUser]].ChannelId = "msteams"
- [[ChatUser]].UserId - Stores an unique identifier of the MS Teams user account.
- [[ChatUser].Email
- [[ChatUser].FirstName
- [[ChatUser].Lastname
- [[ChatUser].DomainUserName
Step 2. Create a bot using Developer Portal and download the app package
- In the Teams client, open the Developer Portal. From the ... overflow menu on the left, click Developer Portal.
- Search for Developer Portal.
- Click on Developer Portal.
- Click the Apps tab, then click New App.
- Type a name for your app and click Create.
- On the Configure menu, click Basic Information.
- Provide your app details.
- Click Save.
- On the Configure menu, click Permissions and under Device Permissions, select Send the user notifications.
- Click Save.
- From the Configure menu, click App features and on the right pane, click Bot.
- Tap on Enter a bot ID and in the field below enter the Microsoft Application ID associated to your DRUID chatbot (the one generated in DRUID after the channel activation).
- Select the capabilities and scopes your bot will need: Upload and download files, scopes Personal and Team.
- Scroll down and click Save.
- If you want your bot to benefit the sensitive data manipulation:
- On the Configure menu, click Domains.
- Add the following domains:
token.botframework.com- DRUID API domain that is specific to the DRUID Cloud you're using:
- At the top right corner of the page, click the Distribute button. A pop-up appears.
- Click Download the app package.
The Teams Developer Portal opens.
If Developer Portal isn't already installed, install it:
The app is now available when clicking … on the left menu.
In the Microsoft Partner ID field, enter the DRUID MPN (the one generated in DRUID after the channel activation).
| DRUID Community | PROD Europe | PROD US | PROD Australia |
|---|---|---|---|
druidapi.comm.eu.druidplatform.com
|
prod-DRUID-api.azurewebsites.net
|
druidapi.us.druidplatform.com
|
druidapi.au.druidplatform.com
|
The app package is successfully downloaded in your default download folder.
Step 3. Validate your app
To validate your app, follow these steps:
- From the Publish menu, click App validation.
- In the App Validation page, click Get Started.
- Acknowledge the three steps on the screen and click Start validation.
When the app validation completes successfully, you can publish the app to your org, publish to the Teams store or install it in MS Teams.
Step 4. Install the Druid bot in MS Teams
The bot installation in MS Teams is done progressively (not instantly); so it might take up to 48 hours for the installation to complete depending on how many MS Team members you have.
During the bot installation, the bot appears to your Team members on the left menu and sends them the welcome message set on the bot. If you want to prevent the bot from sending the welcome message until its installation in MS Teams completes, temporarily disable the Welcome flow (in Druid Portal, go to the bot details, section Dialogue management and leave the Welcome flow field empty).
To integrate the Druid bot in a MS team, in MS teams, from the left menu, click Teams. Right click on a team that you created and select Manage team.
The Team page appears by default on the Members tab.
Click the Apps tab, then click Upload an app.
Browse for the app package you downloaded at Step 2, select it and click Open. If the Microsoft manifest passed, the Druid bot installation starts in the selected team.
Limitations
MS Teams has a limited pagination for hero cards and buttons with repeater, as follows:
- For hero buttons with repeater, a bulk of 6 will be shown per page.
- For hero cards with repeater, a bulk of 9 will be shown per page.
Inactivating the channel
To inactivate the channel, go to the Channels page and turn off the Enabled toggle on the MS Teams card.
Related Topics